<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    <title>title</title>
  </head>
  <body bgcolor="#FFFFFF">
    <center>Scilab Function</center>
    <div align="right">Last update : 28/04/2006</div>
    <p>
      <b>title</b> - display a title on a graphic
  window</p>
    <h3>
      <font color="blue">Calling Sequence</font>
    </h3>
    <dl>
      <dd>
        <tt>title(my_title)</tt>
      </dd>
      <dd>
        <tt>title(my_title,&lt;Property&gt;)</tt>
      </dd>
      <dd>
        <tt>title(&lt;axes_handle&gt;,&lt;my_title&gt;,&lt;Property&gt;)</tt>
      </dd>
    </dl>
    <h3>
      <font color="blue">Parameters</font>
    </h3>
    <ul>
      <li>
        <tt>
          <b>my_title</b>
        </tt>: a string, it's the title to display</li>
      <li>
        <tt>
          <b>&lt;Property&gt;</b>
        </tt>: This optional argument represents a sequence of couple
          statements <tt>
          <b>{PropertyName,PropertyValue}</b>
        </tt> that defines
          global objects' properties applied to the created title.</li>
      <li>
        <tt>
          <b>&lt;axes_handle&gt;</b>
        </tt>: This optional argument forces the title to appear inside the
          selected axes given by <tt>
          <b>axes_handle</b>
        </tt> rather than the
          current axes (see <a href="gca.htm">
          <tt>
            <b>gca</b>
          </tt>
        </a>).</li>
    </ul>
    <h3>
      <font color="blue">Description</font>
    </h3>
    <p>
      <tt>
        <b>title</b>
      </tt> displays a title on a graphic window. </p>
    <p>The <tt>
        <b>Property</b>
      </tt> arguments should be used to customize the
    title. Here is a complete list of the available options.</p>
    <dl>
      <dd>
        <b></b>
      </dd>
    </dl>
    <dl>
      <dd>
        <b>Property :</b>
        <p>
          <tt>
            <b>backgroundcolor</b>
          </tt>: this field contains the color used to
        fill the box if any. Its value should be a color index (relative to
        the current colormap). </p>
        <p>
          <tt>
            <b>color</b>
          </tt>: this field contains the color used to display
        the title text. Its value should be a color index (relative to the
        current colormap). </p>
        <p>
          <tt>
            <b>edgecolor</b>
          </tt>: this field contains the color used to
        display the line around the box if any. Its value should be a color
        index (relative to the current colormap). </p>
        <p>
          <tt>
            <b>fontname</b>
          </tt>: Seven differents fonts are available :
        "Courrier", "Symbol", "Times", "Times Italic", "Times Bold", "User
        defined". The font_size property is an index in [0 6] which is
        associated to the previous font names. </p>
        <p>
          <tt>
            <b>fontsize</b>
          </tt>: The fontsize property is used to select the
        type of size of the title. Its value should be an integer in between 0
        and 5 which stands for 8pt, 10pt, 12pt, 14pt, 18pt and 24pt.</p>
        <p>
          <tt>
            <b>position</b>
          </tt>: This 2d vector allows you to place manually
        the title on the screen. The position is stored in the data units of
        the axes. </p>
        <p>
          <tt>
            <b>rotation</b>
          </tt>: This scalar allows you to turn the title.
        The font is turned inverse clockise with the angle given in degrees.
        </p>
        <p>
          <tt>
            <b>visible</b>
          </tt>: this field contains the visible property
        value for the title. It should be "on" or "off". By default, the label
        is visible, the value's property is "on" . If "off" the title is not
        displayed on the screen. </p>
      </dd>
    </dl>
    <h3>
      <font color="blue">Examples</font>
    </h3>
    <pre>// display a title with several properties 
title('my title');
// change the color for the font
title('my title','color','blue');
// change the color for the around the box
title('my title','edgecolor','red');
// change the position of the title 
title('my title','position',[0.3 0.8]);
// change the size of the font
title('my title','fontsize',3);
// a rotation 
title('my title','rotation',90);

// We can do all these modifications with just the below instruction:
title('my title','color','blue','edgecolor','red','fontsize',3,'rotation',90,'position',[0.3 0.8]);

</pre>
    <h3>
      <font color="blue">See Also</font>
    </h3>
    <p>
      <a href="label_properties.htm">
        <tt>
          <b>label_properties</b>
        </tt>
      </a>,&nbsp;&nbsp;<a href="titlepage.htm">
        <tt>
          <b>titlepage</b>
        </tt>
      </a>,&nbsp;&nbsp;<a href="xtitle.htm">
        <tt>
          <b>xtitle</b>
        </tt>
      </a>,&nbsp;&nbsp;</p>
    <h3>
      <font color="blue">Author</font>
    </h3>
    <p>F.Belahcene</p>
  </body>
</html>
